localeconv関数は、現在のロケールの数値書式に関する詳細情報を取得します。

この情報は、lconv型の構造体に格納されます。

#include <locale.h>
struct lconv *localeconv( void );

引数はありません。

戻り値として、lconv型の構造体のポインタが返されます。

このポインタの指すメモリは関数内で確保されるため、実体を準備する必要はありません。

lconv型の構造体のメンバを以下に記載します。

これらの値は、以降の処理で書き換えられる可能性があるため、直接変更しないでください。












































































char *decimal_point 通貨以外の数値で使用する小数点の文字
char *thousands_sep 通貨以外の数値で使用する整数部の桁を区切る文字
char *grouping 通貨以外の数値の区切りを入れる桁数を示す値の入った配列

以下の値をとります。

「CHAR_MAX」: 区切りをいれません。

「0」: 残りの各桁の区切りは直前の要素の桁数を使用します。

「n」(1以上): 区切りを入れる桁数。

char *int_curr_symbol 国際通貨記号

以下の規則に則って解釈します。

・最初の3文字は、ISO4217規格で定義されている英字の国際通貨記号

・4番目の文字(NULL文字の直前にある文字)は、国際通貨記号と通貨値を区切る記号

char *currency_symbol 通貨記号
char *mon_decimal_point 通貨で使用する小数点の文字
char *mon_thousands_sep 通貨で使用する整数部の数字の桁を区切る文字
char *mon_grouping 通貨の区切りを入れる桁数を示す値の入った配列

以下の値をとります。

「CHAR_MAX」: 区切りをいれません。

「0」: 残りの各桁の区切りは直前の要素の桁数を使用します。

「n」(1以上): 区切りを入れる桁数。

char *positive_sign 0及び正の通貨値の、符号を示す文字列
char *negative_sign 負の通貨値の、符号を表す文字列
char int_frac_digits 国際的な通貨書式の小数部の桁数
char frac_digits 通貨書式の小数部の桁数
char p_cs_precedes 通貨記号が、

0及び正の通貨値の前にある場合は「1」

0及び正の通貨値の後ろにある場合は「0」

char p_sep_by_space 通貨記号と0及び正の通貨値が、

空白で区切られている場合は「1」

空白で区切られていない場合は「0」

char n_cs_precedes 通貨記号が、

負の通貨値の前にある場合は「1」

負の通貨値の後ろにある場合は「0」

char n_sep_by_space 通貨記号と負の通貨値が、

空白で区切られている場合は「1」

空白で区切られていない場合は「0」

char p_sign_posn 0及び正の通貨書式の符号の位置

以下の値をとります。

「0」: 数値と通貨記号をかっこで囲む

「1」: 符号文字列が、数値と通貨記号の前にある

「2」: 符号文字列が、数値と通貨記号の後ろにある

「3」: 符号文字列が、通貨記号の直前にある

「4」: 符号文字列が、通貨記号の直後にある

char n_sign_posn 負の通貨書式の符号の位置

以下の値をとります。

「0」: 数値と通貨記号をかっこで囲む

「1」: 符号文字列が、数値と通貨記号の前にある

「2」: 符号文字列が、数値と通貨記号の後ろにある

「3」: 符号文字列が、通貨記号の直前にある

「4」: 符号文字列が、通貨記号の直後にある


※char * 型メンバは文字ではなく文字列へのポインタです。また、char *decimal_point以外で ” に等しいメンバは、長さが0か、現在のロケールでサポートされていないものです。

※構造体の char型メンバは、0以上の数値を表しますが、CHAR_MAXと等しいメンバがあった場合、そのメンバは現在のロケールでサポートされていないことを示しています。

プログラム 例

#include <stdio.h>
#include <locale.h>

int main(void)
{
    char *loc;
    struct lconv *stLc;

    /* ロケール情報を'jpn'(日本)に設定し、取得 */
    loc = setlocale(LC_ALL, 'jpn');
    printf('locale = %sn', loc);

    /* ロケールに関する詳細情報を取得 */
    stLc = localeconv();
    printf(' decimal_point = %sn', stLc->decimal_point);
    printf(' thousands_sep = %sn', stLc->thousands_sep);
    printf(' grouping[0] = %dn', stLc->grouping[0]);
    printf(' grouping[1] = %dn', stLc->grouping[1]);
    printf(' int_curr_symbol = %sn', stLc->int_curr_symbol);
    printf(' currency_symbol = %sn', stLc->currency_symbol);
    printf(' mon_decimal_point = %sn', stLc->mon_decimal_point);
    printf(' mon_thousands_sep = %sn', stLc->mon_thousands_sep);
    printf(' mon_grouping[0] = %dn', stLc->mon_grouping[0]);
    printf(' mon_grouping[1] = %dn', stLc->mon_grouping[1]);
    printf(' positive_sign = %sn', stLc->positive_sign);
    printf(' negative_sign = %sn', stLc->negative_sign);
    printf(' int_frac_digits = %dn', stLc->int_frac_digits);
    printf(' frac_digits = %dn', stLc->frac_digits);
    printf(' p_cs_precedes = %dn', stLc->p_cs_precedes);
    printf(' p_sep_by_space = %dn', stLc->p_sep_by_space);
    printf(' n_cs_precedes = %dn', stLc->n_cs_precedes);
    printf(' n_sep_by_space = %dn', stLc->n_sep_by_space);
    printf(' n_sign_posn = %dn', stLc->n_sign_posn);

    printf('n');

    /* ロケール情報を'us'(米国)に設定し、取得 */
    loc = setlocale(LC_ALL, 'us');
    printf('locale = %sn', loc);

    /* ロケールに関する詳細情報を取得 */
    stLc = localeconv();
    printf(' int_curr_symbol = %sn', stLc->int_curr_symbol);
    printf(' currency_symbol = %sn', stLc->currency_symbol);
    /* 他メンバは抜粋します */

    return 0;
}

例の実行結果

> localeconv.exe
locale = Japanese_Japan.932
 decimal_point = .
 thousands_sep = ,
 grouping[0] = 3
 grouping[1] = 0
 int_curr_symbol = JPY
 currency_symbol = 
 mon_decimal_point = .
 mon_thousands_sep = ,
 mon_grouping[0] = 3
 mon_grouping[1] = 0
 positive_sign =
 negative_sign = -
 int_frac_digits = 2
 frac_digits = 0
 p_cs_precedes = 1
 p_sep_by_space = 0
 n_cs_precedes = 1
 n_sep_by_space = 0
 n_sign_posn = 3

locale = English_United States.1252
 int_curr_symbol = USD
 currency_symbol = $

※Windows環境でのみ動作確認しております。LINUX環境などでは動作が異なる場合がありますので、その場合は環境に合わせてカスタマイズしてください。

Copyright © 2011 katsumi Handa All Rights Reserved.